Skip to main content

Telegram Bot Setup

Setting up your Telegram Bot | Node Health Monitoring

The Snapshotter-lite nodes currently require manual monitoring to detect any issues.

Introducing the PowerloomReportingBot! This bot service maintains an internal health state and reports any issues to operators, such as failed or missed snapshots. This guide provides instructions for setting up your Powerloom Telegram Bot to monitor the health of your node.

Telegram Bot Setup Instructions:

  • Step 1: Open a new conversation with @PowerloomReportingBot in the Telegram App.

  • Step 2: Start the bot by typing /start to activate the bot. This will provide you with a Chat ID.

    note

    The PowerloomSnapshotterReportingService will never ask you for any personal information or private keys. Ensure that you have started a conversation with the correct bot, and do not provide any information besides the /start command under any circumstances.

    chatID-start

  • Step 3: Provide the Chat ID to your Snapshotter Lite node:

    • If you are setting up the node for the first time, enter the Chat ID when prompted on the terminal during the node setup:

      telegram-promp

    • If you have a running node and would like to add the Telegram reporting feature, there are two options that you can use:

      Option 1: Update your .env file with the generated Chat ID as seen in the image below. Once updated, run the ./build.sh command again to restart the node.

      updated-env-screenshot

      Option 2: Delete your .env file, and then run the ./build.sh command again to trigger a recreation of the .env. This will remove all values from the initial setup, so ensure that you have these available.

To check if the Bot is successfully running, try these:

  • Limit API request rates per second
  • Limit the API being requested by specifying the allowed API methods. (e.g. eth_getBlockNumber)

If you see messages of failed or missed snapshots like the images below, know that the bot is running successfully.

failed-snapshot


Reach out to the team on Discord. Our goal is to ensure your node runs smoothly, and we're here to help with any challenges you might face.